home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / maximus / tcall110.zip / TCALL.DOC next >
Text File  |  1992-10-17  |  5KB  |  115 lines
  1.  
  2.  
  3.  
  4.                                   TCall v1.10
  5.  
  6.                                 October 17, 1992
  7.  
  8.                       Copyright (c) 1992 by Mark R. Evans
  9.                               All Rights Reserved.
  10.  
  11.  
  12.  
  13.      LICENSE
  14.      -------
  15.      Permission granted to use this program, and distribute it to others.
  16.      The original documentation and program must be distributed in
  17.      unmodified form.  For information, contact the author at FidoNet
  18.      1:382/91.1, or P. O. Box 163611, Austin, TX 78716, USA.
  19.  
  20.      WARRANTY AND STATEMENT OF LIABILITY
  21.      -----------------------------------
  22.      TCALL does not carry any warranty of any kind, including that of
  23.      fitness for any particular purpose.  You use TCALL at your own risk.
  24.      If it causes damage to your hard disk, your life, your marriage, etc.,
  25.      you take full responsibility.  You acknowledge this in full by using
  26.      TCALL.  TCALL is not licensed for legal use in any jurisdiction where
  27.      local or regional law renders this Warranty and Statement of Liability
  28.      invalid.
  29.  
  30.      COST
  31.      ----
  32.      TCALL is free.  Use it for free, distribute it for free.  You may not
  33.      charge any fee for distribution of TCALL.
  34.  
  35.      DESCRIPTION
  36.      -----------
  37.      TCALL is a program that will create a bulletin listing everyone who
  38.      has called your Maximus-CBCS v2.x BBS today and/or yesterday.  TCall
  39.      differs from other call listers in that it does not read the USER.BBS
  40.      file, instead it looks at the LASTUS##.BBS file to build the caller
  41.      list.  This allows TCall to show _every_ call to your BBS.  TCall was
  42.      designed to be flexible enough to serve everyone's needs.  Some
  43.      features of TCall are:
  44.  
  45.           o    Can use Real Names, Aliases, or Both
  46.           o    Optionally exclude calls from the Sysop
  47.           o    Ability to run in a multitasking environment
  48.           o    Optionally display the previous days callers
  49.           o    Bound application so it can run under DOS or OS/2
  50.           o    On-line times and download bytes are 100% accurate per call
  51.  
  52.      USAGE
  53.      -----
  54.      TCALL _MUST_ be run from the same directory where Maximus is stored.
  55.      TCALL uses the following command line parameters:
  56.  
  57.      Usage: TCALL [options]
  58.           -s   DO NOT include calls from Sysop.
  59.           -n   Task/Node Number to use. (REQUIRED).
  60.           -t   Title for bulletin, if this contain spaces, it _MUST_ be
  61.                enclosed in quotes!  Default is no title.
  62.           -r   Use RealNames (default).
  63.           -a   Use Alias names.
  64.           -o   Directory to place the TCALL##.BBS Bulletin.
  65.           -y   Add yesterday's stats to bulletin.
  66.           -u   Only update the bulletin, do not write to data file!
  67.  
  68.      Note: Both -r and -a can be used to display both real and alias names.
  69.      Note: If you specify -a (alias names), then real names WILL NOT be
  70.      displayed.
  71.  
  72.      Example:  TCALL -n1 -t"BBS Name Here" -r -a -y
  73.  
  74.      TCall requires that the -n switch be used. I suggest that you place
  75.      TCall in your RUNBBS.BAT (or whatever you call yours) batch file to
  76.      execute after each caller.  TCall will update it's data files and
  77.      generate the caller bulletin.
  78.  
  79.      To display the bulletin, add a new menu item using the following
  80.      format:
  81.  
  82.           Display_File   TCall%K    SysOp   "Today's Callers"
  83.  
  84.      The %K is translated by Maximus-CBCS to the current TASK number.
  85.  
  86.      To display this bulletin at the local console, you can use ORACLE to
  87.      view it as follows:
  88.  
  89.           ORACLE TCall##
  90.  
  91.      Replace the ## with the task number that your BBS is using.
  92.  
  93.      HOW DOES IT WORK?
  94.      -----------------
  95.      After each caller logs off, TCall reads the LASTUS##.BBS file, updates
  96.      it's data file (TCALL##.DAT) and generates the bulletin file
  97.      (TCALL##.BBS). Also, TCall will check the current system date to the
  98.      TCALL##.DAT file, if the dates are different (implying we have passed
  99.      midnight), TCall will rename it's data file to TCALL##.YES and create
  100.      a new TCALL##.DAT file.  This allows you to see both today's callers
  101.      as well as yesterdays callers.  TCall also uses a file called
  102.      TCLOK.DAT for locking the data records in a multi-user environment.
  103.  
  104.      Note: ## is replaced by the task number specified with the -n switch.
  105.  
  106.      BUGS, ANOMALIES, PROBLEMS
  107.      -------------------------
  108.      There is one know minor anomaly that you should be aware of:
  109.  
  110.      1.   Each time you run TCALL without the -u switch, it will read the
  111.           LASTUS##.BBS file and add another record to the TCALL##.DAT file.
  112.           If you just want to re-generate the .BBS file (possibly changing
  113.           the title or adding yesterdays info), without updating the data
  114.           file, you MUST use the -u command line switch.
  115.